Bezeichnung


PG:OpenDatabase -- stellt eine neue Verbindung zur einer PostgreSQL Datenbank bereit.


Übersicht


Fail, ErrorCode, ConnectionID = PG:OpenDatabase(Host$, Port, Database$, Username$, Password$)


Beschreibung


Die Funktion stelle eine Verbindung zu einer PostgreSQL Datenbank her. Das Argument Database$ ist der Name der Datenbank mit welcher Sie sich verbinden möchten. Das Argument Username$ gibt an mit welchem PostgreSQL - Usernamen Sie sich anmelden möchten. Password$ ist logischer weise das Passwort des Users.

Host$ ist die Adresse des PgSQL-Servers und Port natürlich die Port-Nummer an welchem der Server "lauscht".


Bitte beachten Sie: Diese Library unterstützt aktuell nur die MD5 Authentifikation.


Wenn die Verbindung erfolgreich war ist Fail = False, ansonsten bei einem Fehler True.

Sollte ein Fehler auftreten, enthält ErrorCode entweder einen dreistelligen internen Fehlercode oder einen fünfstelligen PostgreSQL Fehlercode.


Die Library internen Fehlercodes finden Sie hier.

Die Fehlercodes der PostgreSQL Datenbank sind hier beschrieben.


 

Eingaben


Host$

Adresse des PgSQL-Servers. Beispiele: "localhost" oder "www.meinedb.de" oder "127.0.0.1"


Port

Der Port an dem Der Server lauscht. PgSQL Standard ist 5432  


Database$

               Name der Datenbank


Username$

               PostgreSQL User


Password$

               Passwort des Users



Rückgabewerte


Fail

True wenn ein Fehler aufgetreten ist.

False, also 0 wenn alles funktioniert hat.


ErrorCode

Einen dreistelligen internen Fehlercode oder einen fünfstelligen PostgreSQL Fehlercode.

Ansonsten 0


ConnectionID

Der Netzwerk Identifikator.


Beispiel


/****************************************************************

**                                                             **

** Name:        1_OpenDatabase                                 **

** Author:      Michael Suther                                 **

** Date:        01.05.19                                       **

** Interpreter: Hollywood 8.0                                  **

** Function:    Open and close a PosgreSQL DB                       **

**                                                             **

**                                                             **

****************************************************************/


@INCLUDE "PostgreSQL_Lib.hws"


Block        

       

       Local Fail, ConnectionID

       Local Errorcode

       Local Host$ = "localhost"

       Local Port = 5432

       Local Database$ = "postgres"

       Local Username$ = "test"

       Local Passwort$ = "test"

       

       ;registration

       Fail, ErrorCode, ConnectionID = PG:OpenDatabase(Host$, Port, Database$, Username$, Passwort$)


       ; Evaluating the Return values

       If Fail = False 

               NPrint("Connection was successfully established.")

       Else

               NPrint("")

               NPrint("The connection failed.")

               NPrint("")

               NPrint("Error code:  ", ErrorCode)

       EndIf

       

       WaitLeftMouse        

       

       ;Close connection To the database.

       PG:CloseDatabase(ConnectionID)

               

EndBlock



Mit dem Personal Edition von HelpNDoc erstellt: Einfacher CHM- und Dokumentationseditor